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CDACSMsgProplterator 



£ m_oProplteratort1sqPropMap::iterator 
O m^rofaoptlsgPropMa^HyULL 



^CDACSMsqProplteratorO 
^-CDACSMsgPrfiplteratoK) 

<^operator++0 

<^ResetO 

^>!sEndO 

<^GetKeyO 

^GetVqlbeO 

<^SetVdbe() 



<^CDACSMessaqeO 
^-CDACSMessageO 
<^> GetMessageTypeO 
<^SetMessageTv 
^GetMessaqeldl 
^SetMessadeWO 
<^GetPrope?ty() 
^GetProbertyO 
OGetPropertVO 
<^GetProbertyO 

<^SetProberty() 

^SetProbertW) 

^SetPrpbertyO 

<^AttachToh6ratorO 

^GetPropertyCountO 

^HasPro^ertiesO 

^ ClearPropertiesO 

^NtDocumentO 

<^ AttacnDocumentO 

<^ CopylnDpcumentO 

O ApbendDocumentO 

^> DeTachDocumentO 

<^GetDocument() 

^> CopyOutOocumentO 

^> GeTOocumentLengthO 

<^> ReserveOocumenfSpaceO 

<^HasDocument() 

<s>EmptyDocument() 

<^>Save() 

<^Load() 
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^>«virtud»— CGUBas... 
O «static»— AcquireSys.. 
^CGUBaseOb jO 1 

t£> CreateErrorlnf oO 
^CreateErrorhf oO 
&£> GetErrorCodeO 
6£> GetEirorDescriptionO 
t£> GetEirorDetailedDesc.. 
OGetErrolnfoO 
S$> Get&rorSourceO 
O«static»LoqError0 
<^«static»LoQError() 
^«static»LogError() 





1 iH x 

InitDocument 


Initially allocates a butter ot a given size tor 
m_bstrDocument. but sets the length to zero. 


AttachDocument 


Attaches a BSTR to the CDACSMessage 
object as the header. 


LopylnDocument 


J j DOTH i 1 x P\ i 

Copies a provided BSIR to m_bstrDocument. 
Similar to operator = for CComBSTR. 


a Ip\ • 

AppendDocument 


A 1 P) o TD i 1 , p\ , 

Appends a BSTR to m_bstrDocument. 


DetachDocument 


Detaches m_bstrDocument trom 
the CDACSMessage object. 


i p\ . 

betDocument 


Pi _l | , p\ i 

Returns m_bstrUocument. 

Similar to operator BSTR for CComBSR. 


CopyOutDocument 


Returns a copy ot m_bstrDocument. 


i i pv i 

HasDocument 


p> # ~tp»i ii — - r i . i r I • p\ . , 

Returns 1 RUb it length ot m_bstrUocument is not 
zero. Compare to operator ! for CComBSTR. 


UetDocument- 
Length 


Returns the lenqth in characters 
of m_bstrDocument. 


ReserveDocument- 
Space 


Allocates space tor the document butter. 

Makes multiple AppendDocument calls more efficient. 


SetDocument- 
Length 


Sets the length in characters of m_bstrDocument. 


EmptyDocument 


Frees m_bstrDocument. 
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7 InitDfiriimpntO 




3 Appgn HDoriimpntO 



4 .^AtPrnpArtyf) 
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^^51 Transportable Message 



T 



Message producer optionally initializes l\ 
document to total anticipated size needed, 
then builds up the actual document by 
repeated calls to AppendDocument. 



Message producer adds properties that l\ 
further define the message. Message 
does not have to have both properties 
and a document. One or the other can 
fully define a message. 



L 
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Message # 


Description 


1 


Constructs the message object. Property list and document 
initialy empty. Message Type and ID constructed as in declaration. 


2 


Reserve space for the document, with the initial length set to zero. 


3 


Add a character string to the document. Repeat until done. 


4 


Add a property to the message. Repeat until done. 


5 


Package the entire message object into a single BSTR. wrapped 
in the caller's CComVariant parameter. 


5.1 


The transportable data is attached to the callers CComVariant 
parameter. 



Message 
Consumer 
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Message 
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^ fiat Jyp^O 



4 fietinn 



5 fifttPrnpftrtyfl 



fi fifttDnfiffnftntfl 



3 



fil Pointer tn flora 



7. interpret document contents 



>s ^ . I Messaqe consumer gets properties that I\ 

help define the message and may help 

\J interpret the document. A message m< 



may 

consist only of properties or only' of a 
document. 
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Message # 


Description 


1 


Document and property list initially empty. Initial message type 
and id will be overriddent in the next step. 


2 


Copy data from the received VARIANT data to the 
CDACSMessage object. 


3 


Get the message type property. 


4 


Get the message id property. 


5 


Get a specific message property. Repeat as needed 
Alternatively, the message consumer can retrieve all the 
properties in a loop. 


6 


Get a pointer to the document buffer. Alternatively, the message 
consumer could use DetachDocument to take responsibility for the buffer 


6J 




7 


Document is an optional attachment that contains message data in 
some format such as XML Semantics are defined by the consumer. 



